package cn.iocoder.yudao.module.resource.service.usertimebalance;

import java.util.*;

import cn.iocoder.yudao.module.resource.controller.admin.usertimebalance.vo.UserTimeBalancePageReqVO;
import cn.iocoder.yudao.module.resource.controller.admin.usertimebalance.vo.UserTimeBalanceSaveReqVO;
import cn.iocoder.yudao.module.resource.dal.dataobject.usertimebalance.UserTimeBalanceDO;
import jakarta.validation.*;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;

/**
 * 用户时长余额 Service 接口
 *
 * @author lizhongwen
 */
public interface UserTimeBalanceService {

    /**
     * 创建用户时长余额
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    String createUserTimeBalance(@Valid UserTimeBalanceSaveReqVO createReqVO);

    /**
     * 更新用户时长余额
     *
     * @param updateReqVO 更新信息
     */
    void updateUserTimeBalance(@Valid UserTimeBalanceSaveReqVO updateReqVO);

    /**
     * 删除用户时长余额
     *
     * @param id 编号
     */
    void deleteUserTimeBalance(String id);

    /**
     * 获得用户时长余额
     *
     * @param id 编号
     * @return 用户时长余额
     */
    UserTimeBalanceDO getUserTimeBalance(String id);

    /**
     * 获得用户时长余额分页
     *
     * @param pageReqVO 分页查询
     * @return 用户时长余额分页
     */
    PageResult<UserTimeBalanceDO> getUserTimeBalancePage(UserTimeBalancePageReqVO pageReqVO);

    UserTimeBalanceDO getUserTimeBalanceByUserId(Long userId);

    UserTimeBalanceDO getUserTimeBalanceByUserIdWithNewUserGive(Long userId);

}